/ Celestin Apprentice 2 / Apprentice-Release2.iso / Tools / Languages / Python 1.1 / Doc / libposix.tex

< prev

next >

MacOS 8.1

Win98

DOS

view JSON data

view as text

+--------+-------------------------+-------------------------+--------+--------+
|00000000| 5c 73 65 63 74 69 6f 6e | 7b 42 75 69 6c 74 2d 69 |\section|{Built-i|
|00000010| 6e 20 4d 6f 64 75 6c 65 | 20 5c 73 65 63 74 63 6f |n Module| \sectco|
|00000020| 64 65 7b 70 6f 73 69 78 | 7d 7d 0d 0d 5c 62 69 6d |de{posix|}}..\bim|
|00000030| 6f 64 69 6e 64 65 78 7b | 70 6f 73 69 78 7d 0d 0d |odindex{|posix}..|
|00000040| 54 68 69 73 20 6d 6f 64 | 75 6c 65 20 70 72 6f 76 |This mod|ule prov|
|00000050| 69 64 65 73 20 61 63 63 | 65 73 73 20 74 6f 20 6f |ides acc|ess to o|
|00000060| 70 65 72 61 74 69 6e 67 | 20 73 79 73 74 65 6d 20 |perating| system |
|00000070| 66 75 6e 63 74 69 6f 6e | 61 6c 69 74 79 20 74 68 |function|ality th|
|00000080| 61 74 20 69 73 0d 73 74 | 61 6e 64 61 72 64 69 7a |at is.st|andardiz|
|00000090| 65 64 20 62 79 20 74 68 | 65 20 43 20 53 74 61 6e |ed by th|e C Stan|
|000000a0| 64 61 72 64 20 61 6e 64 | 20 74 68 65 20 50 4f 53 |dard and| the POS|
|000000b0| 49 58 20 73 74 61 6e 64 | 61 72 64 20 28 61 20 74 |IX stand|ard (a t|
|000000c0| 68 69 6e 6c 79 20 64 69 | 67 75 69 73 65 64 0d 5c |hinly di|guised.\|
|000000d0| 55 4e 49 58 7b 7d 20 69 | 6e 74 65 72 66 61 63 65 |UNIX{} i|nterface|
|000000e0| 29 2e 0d 49 74 20 69 73 | 20 61 76 61 69 6c 61 62 |)..It is| availab|
|000000f0| 6c 65 20 69 6e 20 61 6c | 6c 20 50 79 74 68 6f 6e |le in al|l Python|
|00000100| 20 76 65 72 73 69 6f 6e | 73 20 65 78 63 65 70 74 | version|s except|
|00000110| 20 6f 6e 20 74 68 65 20 | 4d 61 63 69 6e 74 6f 73 | on the |Macintos|
|00000120| 68 3b 0d 74 68 65 20 4d | 53 2d 44 4f 53 20 76 65 |h;.the M|S-DOS ve|
|00000130| 72 73 69 6f 6e 20 64 6f | 65 73 20 6e 6f 74 20 73 |rsion do|es not s|
|00000140| 75 70 70 6f 72 74 20 63 | 65 72 74 61 69 6e 20 66 |upport c|ertain f|
|00000150| 75 6e 63 74 69 6f 6e 73 | 2e 0d 54 68 65 20 64 65 |unctions|..The de|
|00000160| 73 63 72 69 70 74 69 6f | 6e 73 20 62 65 6c 6f 77 |scriptio|ns below|
|00000170| 20 61 72 65 20 76 65 72 | 79 20 74 65 72 73 65 3b | are ver|y terse;|
|00000180| 20 72 65 66 65 72 20 74 | 6f 20 74 68 65 0d 63 6f | refer t|o the.co|
|00000190| 72 72 65 73 70 6f 6e 64 | 69 6e 67 20 5c 55 4e 49 |rrespond|ing \UNI|
|000001a0| 58 7b 7d 20 6d 61 6e 75 | 61 6c 20 65 6e 74 72 79 |X{} manu|al entry|
|000001b0| 20 66 6f 72 20 6d 6f 72 | 65 20 69 6e 66 6f 72 6d | for mor|e inform|
|000001c0| 61 74 69 6f 6e 2e 0d 0d | 45 72 72 6f 72 73 20 61 |ation...|Errors a|
|000001d0| 72 65 20 72 65 70 6f 72 | 74 65 64 20 61 73 20 65 |re repor|ted as e|
|000001e0| 78 63 65 70 74 69 6f 6e | 73 3b 20 74 68 65 20 75 |xception|s; the u|
|000001f0| 73 75 61 6c 20 65 78 63 | 65 70 74 69 6f 6e 73 20 |sual exc|eptions |
|00000200| 61 72 65 20 67 69 76 65 | 6e 0d 66 6f 72 20 74 79 |are give|n.for ty|
|00000210| 70 65 20 65 72 72 6f 72 | 73 2c 20 77 68 69 6c 65 |pe error|s, while|
|00000220| 20 65 72 72 6f 72 73 20 | 72 65 70 6f 72 74 65 64 | errors |reported|
|00000230| 20 62 79 20 74 68 65 20 | 73 79 73 74 65 6d 20 63 | by the |system c|
|00000240| 61 6c 6c 73 20 72 61 69 | 73 65 0d 5c 63 6f 64 65 |alls rai|se.\code|
|00000250| 7b 70 6f 73 69 78 2e 65 | 72 72 6f 72 7d 2c 20 64 |{posix.e|rror}, d|
|00000260| 65 73 63 72 69 62 65 64 | 20 62 65 6c 6f 77 2e 0d |escribed| below..|
|00000270| 0d 4d 6f 64 75 6c 65 20 | 5c 63 6f 64 65 7b 70 6f |.Module |\code{po|
|00000280| 73 69 78 7d 20 64 65 66 | 69 6e 65 73 20 74 68 65 |six} def|ines the|
|00000290| 20 66 6f 6c 6c 6f 77 69 | 6e 67 20 64 61 74 61 20 | followi|ng data |
|000002a0| 69 74 65 6d 73 3a 0d 0d | 5c 72 65 6e 65 77 63 6f |items:..|\renewco|
|000002b0| 6d 6d 61 6e 64 7b 5c 69 | 6e 64 65 78 73 75 62 69 |mmand{\i|ndexsubi|
|000002c0| 74 65 6d 7d 7b 28 64 61 | 74 61 20 69 6e 20 6d 6f |tem}{(da|ta in mo|
|000002d0| 64 75 6c 65 20 70 6f 73 | 69 78 29 7d 0d 5c 62 65 |dule pos|ix)}.\be|
|000002e0| 67 69 6e 7b 64 61 74 61 | 64 65 73 63 7d 7b 65 6e |gin{data|desc}{en|
|000002f0| 76 69 72 6f 6e 7d 0d 41 | 20 64 69 63 74 69 6f 6e |viron}.A| diction|
|00000300| 61 72 79 20 72 65 70 72 | 65 73 65 6e 74 69 6e 67 |ary repr|esenting|
|00000310| 20 74 68 65 20 73 74 72 | 69 6e 67 20 65 6e 76 69 | the str|ing envi|
|00000320| 72 6f 6e 6d 65 6e 74 20 | 61 74 20 74 68 65 20 74 |ronment |at the t|
|00000330| 69 6d 65 0d 74 68 65 20 | 69 6e 74 65 72 70 72 65 |ime.the |interpre|
|00000340| 74 65 72 20 77 61 73 20 | 73 74 61 72 74 65 64 2e |ter was |started.|
|00000350| 0d 28 4d 6f 64 69 66 79 | 69 6e 67 20 74 68 69 73 |.(Modify|ing this|
|00000360| 20 64 69 63 74 69 6f 6e | 61 72 79 20 64 6f 65 73 | diction|ary does|
|00000370| 20 6e 6f 74 20 61 66 66 | 65 63 74 20 74 68 65 20 | not aff|ect the |
|00000380| 73 74 72 69 6e 67 20 65 | 6e 76 69 72 6f 6e 6d 65 |string e|nvironme|
|00000390| 6e 74 20 6f 66 20 74 68 | 65 0d 69 6e 74 65 72 70 |nt of th|e.interp|
|000003a0| 72 65 74 65 72 2e 29 0d | 46 6f 72 20 65 78 61 6d |reter.).|For exam|
|000003b0| 70 6c 65 2c 0d 5c 63 6f | 64 65 7b 70 6f 73 69 78 |ple,.\co|de{posix|
|000003c0| 2e 65 6e 76 69 72 6f 6e | 5b 27 48 4f 4d 45 27 5d |.environ|['HOME']|
|000003d0| 7d 0d 69 73 20 74 68 65 | 20 70 61 74 68 6e 61 6d |}.is the| pathnam|
|000003e0| 65 20 6f 66 20 79 6f 75 | 72 20 68 6f 6d 65 20 64 |e of you|r home d|
|000003f0| 69 72 65 63 74 6f 72 79 | 2c 20 65 71 75 69 76 61 |irectory|, equiva|
|00000400| 6c 65 6e 74 20 74 6f 0d | 5c 63 6f 64 65 7b 67 65 |lent to.|\code{ge|
|00000410| 74 65 6e 76 28 22 48 4f | 4d 45 22 29 7d 0d 69 6e |tenv("HO|ME")}.in|
|00000420| 20 43 2e 0d 5c 65 6e 64 | 7b 64 61 74 61 64 65 73 | C..\end|{datades|
|00000430| 63 7d 0d 0d 5c 72 65 6e | 65 77 63 6f 6d 6d 61 6e |c}..\ren|ewcomman|
|00000440| 64 7b 5c 69 6e 64 65 78 | 73 75 62 69 74 65 6d 7d |d{\index|subitem}|
|00000450| 7b 28 65 78 63 65 70 74 | 69 6f 6e 20 69 6e 20 6d |{(except|ion in m|
|00000460| 6f 64 75 6c 65 20 70 6f | 73 69 78 29 7d 0d 5c 62 |odule po|six)}.\b|
|00000470| 65 67 69 6e 7b 65 78 63 | 64 65 73 63 7d 7b 65 72 |egin{exc|desc}{er|
|00000480| 72 6f 72 7d 0d 54 68 69 | 73 20 65 78 63 65 70 74 |ror}.Thi|s except|
|00000490| 69 6f 6e 20 69 73 20 72 | 61 69 73 65 64 20 77 68 |ion is r|aised wh|
|000004a0| 65 6e 20 61 6e 20 50 4f | 53 49 58 20 66 75 6e 63 |en an PO|SIX func|
|000004b0| 74 69 6f 6e 20 72 65 74 | 75 72 6e 73 20 61 0d 50 |tion ret|urns a.P|
|000004c0| 4f 53 49 58 2d 72 65 6c | 61 74 65 64 20 65 72 72 |OSIX-rel|ated err|
|000004d0| 6f 72 20 28 65 2e 67 2e | 2c 20 6e 6f 74 20 66 6f |or (e.g.|, not fo|
|000004e0| 72 20 69 6c 6c 65 67 61 | 6c 20 61 72 67 75 6d 65 |r illega|l argume|
|000004f0| 6e 74 20 74 79 70 65 73 | 29 2e 20 20 49 74 73 0d |nt types|).  Its.|
|00000500| 73 74 72 69 6e 67 20 76 | 61 6c 75 65 20 69 73 20 |string v|alue is |
|00000510| 5c 63 6f 64 65 7b 27 70 | 6f 73 69 78 2e 65 72 72 |\code{'p|osix.err|
|00000520| 6f 72 27 7d 2e 20 20 54 | 68 65 20 61 63 63 6f 6d |or'}.  T|he accom|
|00000530| 70 61 6e 79 69 6e 67 20 | 76 61 6c 75 65 20 69 73 |panying |value is|
|00000540| 20 61 0d 70 61 69 72 20 | 63 6f 6e 74 61 69 6e 69 | a.pair |containi|
|00000550| 6e 67 20 74 68 65 20 6e | 75 6d 65 72 69 63 20 65 |ng the n|umeric e|
|00000560| 72 72 6f 72 20 63 6f 64 | 65 20 66 72 6f 6d 20 5c |rror cod|e from \|
|00000570| 63 6f 64 65 7b 65 72 72 | 6e 6f 7d 20 61 6e 64 20 |code{err|no} and |
|00000580| 74 68 65 0d 63 6f 72 72 | 65 73 70 6f 6e 64 69 6e |the.corr|espondin|
|00000590| 67 20 73 74 72 69 6e 67 | 2c 20 61 73 20 77 6f 75 |g string|, as wou|
|000005a0| 6c 64 20 62 65 20 70 72 | 69 6e 74 65 64 20 62 79 |ld be pr|inted by|
|000005b0| 20 74 68 65 20 43 20 66 | 75 6e 63 74 69 6f 6e 0d | the C f|unction.|
|000005c0| 5c 63 6f 64 65 7b 70 65 | 72 72 6f 72 28 29 7d 2e |\code{pe|rror()}.|
|000005d0| 0d 5c 65 6e 64 7b 65 78 | 63 64 65 73 63 7d 0d 0d |.\end{ex|cdesc}..|
|000005e0| 49 74 20 64 65 66 69 6e | 65 73 20 74 68 65 20 66 |It defin|es the f|
|000005f0| 6f 6c 6c 6f 77 69 6e 67 | 20 66 75 6e 63 74 69 6f |ollowing| functio|
|00000600| 6e 73 3a 0d 0d 5c 72 65 | 6e 65 77 63 6f 6d 6d 61 |ns:..\re|newcomma|
|00000610| 6e 64 7b 5c 69 6e 64 65 | 78 73 75 62 69 74 65 6d |nd{\inde|xsubitem|
|00000620| 7d 7b 28 69 6e 20 6d 6f | 64 75 6c 65 20 70 6f 73 |}{(in mo|dule pos|
|00000630| 69 78 29 7d 0d 5c 62 65 | 67 69 6e 7b 66 75 6e 63 |ix)}.\be|gin{func|
|00000640| 64 65 73 63 7d 7b 63 68 | 64 69 72 7d 7b 70 61 74 |desc}{ch|dir}{pat|
|00000650| 68 7d 0d 43 68 61 6e 67 | 65 20 74 68 65 20 63 75 |h}.Chang|e the cu|
|00000660| 72 72 65 6e 74 20 77 6f | 72 6b 69 6e 67 20 64 69 |rrent wo|rking di|
|00000670| 72 65 63 74 6f 72 79 20 | 74 6f 20 5c 76 61 72 7b |rectory |to \var{|
|00000680| 70 61 74 68 7d 2e 0d 5c | 65 6e 64 7b 66 75 6e 63 |path}..\|end{func|
|00000690| 64 65 73 63 7d 0d 0d 5c | 62 65 67 69 6e 7b 66 75 |desc}..\|begin{fu|
|000006a0| 6e 63 64 65 73 63 7d 7b | 63 68 6d 6f 64 7d 7b 70 |ncdesc}{|chmod}{p|
|000006b0| 61 74 68 5c 2c 20 6d 6f | 64 65 7d 0d 43 68 61 6e |ath\, mo|de}.Chan|
|000006c0| 67 65 20 74 68 65 20 6d | 6f 64 65 20 6f 66 20 5c |ge the m|ode of \|
|000006d0| 76 61 72 7b 70 61 74 68 | 7d 20 74 6f 20 74 68 65 |var{path|} to the|
|000006e0| 20 6e 75 6d 65 72 69 63 | 20 5c 76 61 72 7b 6d 6f | numeric| \var{mo|
|000006f0| 64 65 7d 2e 0d 5c 65 6e | 64 7b 66 75 6e 63 64 65 |de}..\en|d{funcde|
|00000700| 73 63 7d 0d 0d 5c 62 65 | 67 69 6e 7b 66 75 6e 63 |sc}..\be|gin{func|
|00000710| 64 65 73 63 7d 7b 63 6c | 6f 73 65 7d 7b 66 64 7d |desc}{cl|ose}{fd}|
|00000720| 0d 43 6c 6f 73 65 20 66 | 69 6c 65 20 64 65 73 63 |.Close f|ile desc|
|00000730| 72 69 70 74 6f 72 20 5c | 76 61 72 7b 66 64 7d 2e |riptor \|var{fd}.|
|00000740| 0d 5c 65 6e 64 7b 66 75 | 6e 63 64 65 73 63 7d 0d |.\end{fu|ncdesc}.|
|00000750| 0d 5c 62 65 67 69 6e 7b | 66 75 6e 63 64 65 73 63 |.\begin{|funcdesc|
|00000760| 7d 7b 64 75 70 7d 7b 66 | 64 7d 0d 52 65 74 75 72 |}{dup}{f|d}.Retur|
|00000770| 6e 20 61 20 64 75 70 6c | 69 63 61 74 65 20 6f 66 |n a dupl|icate of|
|00000780| 20 66 69 6c 65 20 64 65 | 73 63 72 69 70 74 6f 72 | file de|scriptor|
|00000790| 20 5c 76 61 72 7b 66 64 | 7d 2e 0d 5c 65 6e 64 7b | \var{fd|}..\end{|
|000007a0| 66 75 6e 63 64 65 73 63 | 7d 0d 0d 5c 62 65 67 69 |funcdesc|}..\begi|
|000007b0| 6e 7b 66 75 6e 63 64 65 | 73 63 7d 7b 64 75 70 32 |n{funcde|sc}{dup2|
|000007c0| 7d 7b 66 64 5c 2c 20 66 | 64 32 7d 0d 44 75 70 6c |}{fd\, f|d2}.Dupl|
|000007d0| 69 63 61 74 65 20 66 69 | 6c 65 20 64 65 73 63 72 |icate fi|le descr|
|000007e0| 69 70 74 6f 72 20 5c 76 | 61 72 7b 66 64 7d 20 74 |iptor \v|ar{fd} t|
|000007f0| 6f 20 5c 76 61 72 7b 66 | 64 32 7d 2c 20 63 6c 6f |o \var{f|d2}, clo|
|00000800| 73 69 6e 67 20 74 68 65 | 20 6c 61 74 74 65 72 0d |sing the| latter.|
|00000810| 66 69 72 73 74 20 69 66 | 20 6e 65 63 65 73 73 61 |first if| necessa|
|00000820| 72 79 2e 20 20 52 65 74 | 75 72 6e 20 5c 63 6f 64 |ry.  Ret|urn \cod|
|00000830| 65 7b 4e 6f 6e 65 7d 2e | 0d 5c 65 6e 64 7b 66 75 |e{None}.|.\end{fu|
|00000840| 6e 63 64 65 73 63 7d 0d | 0d 5c 62 65 67 69 6e 7b |ncdesc}.|.\begin{|
|00000850| 66 75 6e 63 64 65 73 63 | 7d 7b 65 78 65 63 76 7d |funcdesc|}{execv}|
|00000860| 7b 70 61 74 68 5c 2c 20 | 61 72 67 73 7d 0d 45 78 |{path\, |args}.Ex|
|00000870| 65 63 75 74 65 20 74 68 | 65 20 65 78 65 63 75 74 |ecute th|e execut|
|00000880| 61 62 6c 65 20 5c 76 61 | 72 7b 70 61 74 68 7d 20 |able \va|r{path} |
|00000890| 77 69 74 68 20 61 72 67 | 75 6d 65 6e 74 20 6c 69 |with arg|ument li|
|000008a0| 73 74 20 5c 76 61 72 7b | 61 72 67 73 7d 2c 0d 72 |st \var{|args},.r|
|000008b0| 65 70 6c 61 63 69 6e 67 | 20 74 68 65 20 63 75 72 |eplacing| the cur|
|000008c0| 72 65 6e 74 20 70 72 6f | 63 65 73 73 20 28 69 2e |rent pro|cess (i.|
|000008d0| 65 2e 2c 20 74 68 65 20 | 50 79 74 68 6f 6e 20 69 |e., the |Python i|
|000008e0| 6e 74 65 72 70 72 65 74 | 65 72 29 2e 0d 54 68 65 |nterpret|er)..The|
|000008f0| 20 61 72 67 75 6d 65 6e | 74 20 6c 69 73 74 20 6d | argumen|t list m|
|00000900| 61 79 20 62 65 20 61 20 | 74 75 70 6c 65 20 6f 72 |ay be a |tuple or|
|00000910| 20 6c 69 73 74 20 6f 66 | 20 73 74 72 69 6e 67 73 | list of| strings|
|00000920| 2e 0d 28 4e 6f 74 20 6f | 6e 20 4d 53 2d 44 4f 53 |..(Not o|n MS-DOS|
|00000930| 2e 29 0d 5c 65 6e 64 7b | 66 75 6e 63 64 65 73 63 |.).\end{|funcdesc|
|00000940| 7d 0d 0d 5c 62 65 67 69 | 6e 7b 66 75 6e 63 64 65 |}..\begi|n{funcde|
|00000950| 73 63 7d 7b 65 78 65 63 | 76 65 7d 7b 70 61 74 68 |sc}{exec|ve}{path|
|00000960| 5c 2c 20 61 72 67 73 5c | 2c 20 65 6e 76 7d 0d 45 |\, args\|, env}.E|
|00000970| 78 65 63 75 74 65 20 74 | 68 65 20 65 78 65 63 75 |xecute t|he execu|
|00000980| 74 61 62 6c 65 20 5c 76 | 61 72 7b 70 61 74 68 7d |table \v|ar{path}|
|00000990| 20 77 69 74 68 20 61 72 | 67 75 6d 65 6e 74 20 6c | with ar|gument l|
|000009a0| 69 73 74 20 5c 76 61 72 | 7b 61 72 67 73 7d 2c 0d |ist \var|{args},.|
|000009b0| 61 6e 64 20 65 6e 76 69 | 72 6f 6e 6d 65 6e 74 20 |and envi|ronment |
|000009c0| 5c 76 61 72 7b 65 6e 76 | 7d 2c 0d 72 65 70 6c 61 |\var{env|},.repla|
|000009d0| 63 69 6e 67 20 74 68 65 | 20 63 75 72 72 65 6e 74 |cing the| current|
|000009e0| 20 70 72 6f 63 65 73 73 | 20 28 69 2e 65 2e 2c 20 | process| (i.e., |
|000009f0| 74 68 65 20 50 79 74 68 | 6f 6e 20 69 6e 74 65 72 |the Pyth|on inter|
|00000a00| 70 72 65 74 65 72 29 2e | 0d 54 68 65 20 61 72 67 |preter).|.The arg|
|00000a10| 75 6d 65 6e 74 20 6c 69 | 73 74 20 6d 61 79 20 62 |ument li|st may b|
|00000a20| 65 20 61 20 74 75 70 6c | 65 20 6f 72 20 6c 69 73 |e a tupl|e or lis|
|00000a30| 74 20 6f 66 20 73 74 72 | 69 6e 67 73 2e 0d 54 68 |t of str|ings..Th|
|00000a40| 65 20 65 6e 76 69 72 6f | 6e 6d 65 6e 74 20 6d 75 |e enviro|nment mu|
|00000a50| 73 74 20 62 65 20 61 20 | 64 69 63 74 69 6f 6e 61 |st be a |dictiona|
|00000a60| 72 79 20 6d 61 70 70 69 | 6e 67 20 73 74 72 69 6e |ry mappi|ng strin|
|00000a70| 67 73 20 74 6f 20 73 74 | 72 69 6e 67 73 2e 0d 28 |gs to st|rings..(|
|00000a80| 4e 6f 74 20 6f 6e 20 4d | 53 2d 44 4f 53 2e 29 0d |Not on M|S-DOS.).|
|00000a90| 5c 65 6e 64 7b 66 75 6e | 63 64 65 73 63 7d 0d 0d |\end{fun|cdesc}..|
|00000aa0| 5c 62 65 67 69 6e 7b 66 | 75 6e 63 64 65 73 63 7d |\begin{f|uncdesc}|
|00000ab0| 7b 5f 65 78 69 74 7d 7b | 6e 7d 0d 45 78 69 74 20 |{_exit}{|n}.Exit |
|00000ac0| 74 6f 20 74 68 65 20 73 | 79 73 74 65 6d 20 77 69 |to the s|ystem wi|
|00000ad0| 74 68 20 73 74 61 74 75 | 73 20 5c 76 61 72 7b 6e |th statu|s \var{n|
|00000ae0| 7d 2c 20 77 69 74 68 6f | 75 74 20 63 61 6c 6c 69 |}, witho|ut calli|
|00000af0| 6e 67 20 63 6c 65 61 6e | 75 70 0d 68 61 6e 64 6c |ng clean|up.handl|
|00000b00| 65 72 73 2c 20 66 6c 75 | 73 68 69 6e 67 20 73 74 |ers, flu|shing st|
|00000b10| 64 69 6f 20 62 75 66 66 | 65 72 73 2c 20 65 74 63 |dio buff|ers, etc|
|00000b20| 2e 0d 28 4e 6f 74 20 6f | 6e 20 4d 53 2d 44 4f 53 |..(Not o|n MS-DOS|
|00000b30| 2e 29 0d 0d 4e 6f 74 65 | 3a 20 74 68 65 20 73 74 |.)..Note|: the st|
|00000b40| 61 6e 64 61 72 64 20 77 | 61 79 20 74 6f 20 65 78 |andard w|ay to ex|
|00000b50| 69 74 20 69 73 20 5c 63 | 6f 64 65 7b 73 79 73 2e |it is \c|ode{sys.|
|00000b60| 65 78 69 74 28 5c 76 61 | 72 7b 6e 7d 29 7d 2e 0d |exit(\va|r{n})}..|
|00000b70| 5c 63 6f 64 65 7b 70 6f | 73 69 78 2e 5f 65 78 69 |\code{po|six._exi|
|00000b80| 74 28 29 7d 20 73 68 6f | 75 6c 64 20 6e 6f 72 6d |t()} sho|uld norm|
|00000b90| 61 6c 6c 79 20 6f 6e 6c | 79 20 62 65 20 75 73 65 |ally onl|y be use|
|00000ba0| 64 20 69 6e 20 74 68 65 | 20 63 68 69 6c 64 20 70 |d in the| child p|
|00000bb0| 72 6f 63 65 73 73 0d 61 | 66 74 65 72 20 61 20 5c |rocess.a|fter a \|
|00000bc0| 63 6f 64 65 7b 66 6f 72 | 6b 28 29 7d 2e 0d 5c 65 |code{for|k()}..\e|
|00000bd0| 6e 64 7b 66 75 6e 63 64 | 65 73 63 7d 0d 0d 5c 62 |nd{funcd|esc}..\b|
|00000be0| 65 67 69 6e 7b 66 75 6e | 63 64 65 73 63 7d 7b 66 |egin{fun|cdesc}{f|
|00000bf0| 64 6f 70 65 6e 7d 7b 66 | 64 5c 2c 20 6d 6f 64 65 |dopen}{f|d\, mode|
|00000c00| 7d 0d 52 65 74 75 72 6e | 20 61 6e 20 6f 70 65 6e |}.Return| an open|
|00000c10| 20 66 69 6c 65 20 6f 62 | 6a 65 63 74 20 63 6f 6e | file ob|ject con|
|00000c20| 6e 65 63 74 65 64 20 74 | 6f 20 74 68 65 20 66 69 |nected t|o the fi|
|00000c30| 6c 65 20 64 65 73 63 72 | 69 70 74 6f 72 20 5c 76 |le descr|iptor \v|
|00000c40| 61 72 7b 66 64 7d 2c 0d | 6f 70 65 6e 20 66 6f 72 |ar{fd},.|open for|
|00000c50| 20 72 65 61 64 69 6e 67 | 20 61 6e 64 2f 6f 72 20 | reading| and/or |
|00000c60| 77 72 69 74 69 6e 67 20 | 61 63 63 6f 72 64 69 6e |writing |accordin|
|00000c70| 67 20 74 6f 20 74 68 65 | 20 5c 76 61 72 7b 6d 6f |g to the| \var{mo|
|00000c80| 64 65 7d 20 73 74 72 69 | 6e 67 0d 28 77 68 69 63 |de} stri|ng.(whic|
|00000c90| 68 20 68 61 73 20 74 68 | 65 20 73 61 6d 65 20 6d |h has th|e same m|
|00000ca0| 65 61 6e 69 6e 67 20 61 | 73 20 74 68 65 20 5c 76 |eaning a|s the \v|
|00000cb0| 61 72 7b 6d 6f 64 65 7d | 20 61 72 67 75 6d 65 6e |ar{mode}| argumen|
|00000cc0| 74 20 74 6f 20 74 68 65 | 20 62 75 69 6c 74 2d 69 |t to the| built-i|
|00000cd0| 6e 0d 5c 63 6f 64 65 7b | 6f 70 65 6e 28 29 7d 20 |n.\code{|open()} |
|00000ce0| 66 75 6e 63 74 69 6f 6e | 2e 0d 5c 65 6e 64 7b 66 |function|..\end{f|
|00000cf0| 75 6e 63 64 65 73 63 7d | 0d 0d 5c 62 65 67 69 6e |uncdesc}|..\begin|
|00000d00| 7b 66 75 6e 63 64 65 73 | 63 7d 7b 66 6f 72 6b 7d |{funcdes|c}{fork}|
|00000d10| 7b 7d 0d 46 6f 72 6b 20 | 61 20 63 68 69 6c 64 20 |{}.Fork |a child |
|00000d20| 70 72 6f 63 65 73 73 2e | 20 20 52 65 74 75 72 6e |process.|  Return|
|00000d30| 20 30 20 69 6e 20 74 68 | 65 20 63 68 69 6c 64 2c | 0 in th|e child,|
|00000d40| 20 74 68 65 20 63 68 69 | 6c 64 27 73 20 70 72 6f | the chi|ld's pro|
|00000d50| 63 65 73 73 20 69 64 0d | 69 6e 20 74 68 65 20 70 |cess id.|in the p|
|00000d60| 61 72 65 6e 74 2e 0d 28 | 4e 6f 74 20 6f 6e 20 4d |arent..(|Not on M|
|00000d70| 53 2d 44 4f 53 2e 29 0d | 5c 65 6e 64 7b 66 75 6e |S-DOS.).|\end{fun|
|00000d80| 63 64 65 73 63 7d 0d 0d | 5c 62 65 67 69 6e 7b 66 |cdesc}..|\begin{f|
|00000d90| 75 6e 63 64 65 73 63 7d | 7b 66 73 74 61 74 7d 7b |uncdesc}|{fstat}{|
|00000da0| 66 64 7d 0d 52 65 74 75 | 72 6e 20 73 74 61 74 75 |fd}.Retu|rn statu|
|00000db0| 73 20 66 6f 72 20 66 69 | 6c 65 20 64 65 73 63 72 |s for fi|le descr|
|00000dc0| 69 70 74 6f 72 20 5c 76 | 61 72 7b 66 64 7d 2c 20 |iptor \v|ar{fd}, |
|00000dd0| 6c 69 6b 65 20 5c 63 6f | 64 65 7b 73 74 61 74 28 |like \co|de{stat(|
|00000de0| 29 7d 2e 0d 5c 65 6e 64 | 7b 66 75 6e 63 64 65 73 |)}..\end|{funcdes|
|00000df0| 63 7d 0d 0d 5c 62 65 67 | 69 6e 7b 66 75 6e 63 64 |c}..\beg|in{funcd|
|00000e00| 65 73 63 7d 7b 67 65 74 | 63 77 64 7d 7b 7d 0d 52 |esc}{get|cwd}{}.R|
|00000e10| 65 74 75 72 6e 20 61 20 | 73 74 72 69 6e 67 20 72 |eturn a |string r|
|00000e20| 65 70 72 65 73 65 6e 74 | 69 6e 67 20 74 68 65 20 |epresent|ing the |
|00000e30| 63 75 72 72 65 6e 74 20 | 77 6f 72 6b 69 6e 67 20 |current |working |
|00000e40| 64 69 72 65 63 74 6f 72 | 79 2e 0d 5c 65 6e 64 7b |director|y..\end{|
|00000e50| 66 75 6e 63 64 65 73 63 | 7d 0d 0d 5c 62 65 67 69 |funcdesc|}..\begi|
|00000e60| 6e 7b 66 75 6e 63 64 65 | 73 63 7d 7b 67 65 74 65 |n{funcde|sc}{gete|
|00000e70| 67 69 64 7d 7b 7d 0d 52 | 65 74 75 72 6e 20 74 68 |gid}{}.R|eturn th|
|00000e80| 65 20 63 75 72 72 65 6e | 74 20 70 72 6f 63 65 73 |e curren|t proces|
|00000e90| 73 27 73 20 65 66 66 65 | 63 74 69 76 65 20 67 72 |s's effe|ctive gr|
|00000ea0| 6f 75 70 20 69 64 2e 0d | 28 4e 6f 74 20 6f 6e 20 |oup id..|(Not on |
|00000eb0| 4d 53 2d 44 4f 53 2e 29 | 0d 5c 65 6e 64 7b 66 75 |MS-DOS.)|.\end{fu|
|00000ec0| 6e 63 64 65 73 63 7d 0d | 0d 5c 62 65 67 69 6e 7b |ncdesc}.|.\begin{|
|00000ed0| 66 75 6e 63 64 65 73 63 | 7d 7b 67 65 74 65 75 69 |funcdesc|}{geteui|
|00000ee0| 64 7d 7b 7d 0d 52 65 74 | 75 72 6e 20 74 68 65 20 |d}{}.Ret|urn the |
|00000ef0| 63 75 72 72 65 6e 74 20 | 70 72 6f 63 65 73 73 27 |current |process'|
|00000f00| 73 20 65 66 66 65 63 74 | 69 76 65 20 75 73 65 72 |s effect|ive user|
|00000f10| 20 69 64 2e 0d 28 4e 6f | 74 20 6f 6e 20 4d 53 2d | id..(No|t on MS-|
|00000f20| 44 4f 53 2e 29 0d 5c 65 | 6e 64 7b 66 75 6e 63 64 |DOS.).\e|nd{funcd|
|00000f30| 65 73 63 7d 0d 0d 5c 62 | 65 67 69 6e 7b 66 75 6e |esc}..\b|egin{fun|
|00000f40| 63 64 65 73 63 7d 7b 67 | 65 74 67 69 64 7d 7b 7d |cdesc}{g|etgid}{}|
|00000f50| 0d 52 65 74 75 72 6e 20 | 74 68 65 20 63 75 72 72 |.Return |the curr|
|00000f60| 65 6e 74 20 70 72 6f 63 | 65 73 73 27 73 20 67 72 |ent proc|ess's gr|
|00000f70| 6f 75 70 20 69 64 2e 0d | 28 4e 6f 74 20 6f 6e 20 |oup id..|(Not on |
|00000f80| 4d 53 2d 44 4f 53 2e 29 | 0d 5c 65 6e 64 7b 66 75 |MS-DOS.)|.\end{fu|
|00000f90| 6e 63 64 65 73 63 7d 0d | 0d 5c 62 65 67 69 6e 7b |ncdesc}.|.\begin{|
|00000fa0| 66 75 6e 63 64 65 73 63 | 7d 7b 67 65 74 70 69 64 |funcdesc|}{getpid|
|00000fb0| 7d 7b 7d 0d 52 65 74 75 | 72 6e 20 74 68 65 20 63 |}{}.Retu|rn the c|
|00000fc0| 75 72 72 65 6e 74 20 70 | 72 6f 63 65 73 73 20 69 |urrent p|rocess i|
|00000fd0| 64 2e 0d 28 4e 6f 74 20 | 6f 6e 20 4d 53 2d 44 4f |d..(Not |on MS-DO|
|00000fe0| 53 2e 29 0d 5c 65 6e 64 | 7b 66 75 6e 63 64 65 73 |S.).\end|{funcdes|
|00000ff0| 63 7d 0d 0d 5c 62 65 67 | 69 6e 7b 66 75 6e 63 64 |c}..\beg|in{funcd|
|00001000| 65 73 63 7d 7b 67 65 74 | 70 70 69 64 7d 7b 7d 0d |esc}{get|ppid}{}.|
|00001010| 52 65 74 75 72 6e 20 74 | 68 65 20 70 61 72 65 6e |Return t|he paren|
|00001020| 74 27 73 20 70 72 6f 63 | 65 73 73 20 69 64 2e 0d |t's proc|ess id..|
|00001030| 28 4e 6f 74 20 6f 6e 20 | 4d 53 2d 44 4f 53 2e 29 |(Not on |MS-DOS.)|
|00001040| 0d 5c 65 6e 64 7b 66 75 | 6e 63 64 65 73 63 7d 0d |.\end{fu|ncdesc}.|
|00001050| 0d 5c 62 65 67 69 6e 7b | 66 75 6e 63 64 65 73 63 |.\begin{|funcdesc|
|00001060| 7d 7b 67 65 74 75 69 64 | 7d 7b 7d 0d 52 65 74 75 |}{getuid|}{}.Retu|
|00001070| 72 6e 20 74 68 65 20 63 | 75 72 72 65 6e 74 20 70 |rn the c|urrent p|
|00001080| 72 6f 63 65 73 73 27 73 | 20 75 73 65 72 20 69 64 |rocess's| user id|
|00001090| 2e 0d 28 4e 6f 74 20 6f | 6e 20 4d 53 2d 44 4f 53 |..(Not o|n MS-DOS|
|000010a0| 2e 29 0d 5c 65 6e 64 7b | 66 75 6e 63 64 65 73 63 |.).\end{|funcdesc|
|000010b0| 7d 0d 0d 5c 62 65 67 69 | 6e 7b 66 75 6e 63 64 65 |}..\begi|n{funcde|
|000010c0| 73 63 7d 7b 6b 69 6c 6c | 7d 7b 70 69 64 5c 2c 20 |sc}{kill|}{pid\, |
|000010d0| 73 69 67 7d 0d 4b 69 6c | 6c 20 74 68 65 20 70 72 |sig}.Kil|l the pr|
|000010e0| 6f 63 65 73 73 20 5c 76 | 61 72 7b 70 69 64 7d 20 |ocess \v|ar{pid} |
|000010f0| 77 69 74 68 20 73 69 67 | 6e 61 6c 20 5c 76 61 72 |with sig|nal \var|
|00001100| 7b 73 69 67 7d 2e 0d 28 | 4e 6f 74 20 6f 6e 20 4d |{sig}..(|Not on M|
|00001110| 53 2d 44 4f 53 2e 29 0d | 5c 65 6e 64 7b 66 75 6e |S-DOS.).|\end{fun|
|00001120| 63 64 65 73 63 7d 0d 0d | 5c 62 65 67 69 6e 7b 66 |cdesc}..|\begin{f|
|00001130| 75 6e 63 64 65 73 63 7d | 7b 6c 69 6e 6b 7d 7b 73 |uncdesc}|{link}{s|
|00001140| 72 63 5c 2c 20 64 73 74 | 7d 0d 43 72 65 61 74 65 |rc\, dst|}.Create|
|00001150| 20 61 20 68 61 72 64 20 | 6c 69 6e 6b 20 70 6f 69 | a hard |link poi|
|00001160| 6e 74 69 6e 67 20 74 6f | 20 5c 76 61 72 7b 73 72 |nting to| \var{sr|
|00001170| 63 7d 20 6e 61 6d 65 64 | 20 5c 76 61 72 7b 64 73 |c} named| \var{ds|
|00001180| 74 7d 2e 0d 28 4e 6f 74 | 20 6f 6e 20 4d 53 2d 44 |t}..(Not| on MS-D|
|00001190| 4f 53 2e 29 0d 5c 65 6e | 64 7b 66 75 6e 63 64 65 |OS.).\en|d{funcde|
|000011a0| 73 63 7d 0d 0d 5c 62 65 | 67 69 6e 7b 66 75 6e 63 |sc}..\be|gin{func|
|000011b0| 64 65 73 63 7d 7b 6c 69 | 73 74 64 69 72 7d 7b 70 |desc}{li|stdir}{p|
|000011c0| 61 74 68 7d 0d 52 65 74 | 75 72 6e 20 61 20 6c 69 |ath}.Ret|urn a li|
|000011d0| 73 74 20 63 6f 6e 74 61 | 69 6e 69 6e 67 20 74 68 |st conta|ining th|
|000011e0| 65 20 6e 61 6d 65 73 20 | 6f 66 20 74 68 65 20 65 |e names |of the e|
|000011f0| 6e 74 72 69 65 73 20 69 | 6e 20 74 68 65 20 64 69 |ntries i|n the di|
|00001200| 72 65 63 74 6f 72 79 2e | 0d 54 68 65 20 6c 69 73 |rectory.|.The lis|
|00001210| 74 20 69 73 20 69 6e 20 | 61 72 62 69 74 72 61 72 |t is in |arbitrar|
|00001220| 79 20 6f 72 64 65 72 2e | 20 20 49 74 20 69 6e 63 |y order.|  It inc|
|00001230| 6c 75 64 65 73 20 74 68 | 65 20 73 70 65 63 69 61 |ludes th|e specia|
|00001240| 6c 20 65 6e 74 72 69 65 | 73 0d 5c 63 6f 64 65 7b |l entrie|s.\code{|
|00001250| 27 2e 27 7d 20 61 6e 64 | 20 5c 63 6f 64 65 7b 27 |'.'} and| \code{'|
|00001260| 2e 2e 27 7d 20 69 66 20 | 74 68 65 79 20 61 72 65 |..'} if |they are|
|00001270| 20 70 72 65 73 65 6e 74 | 20 69 6e 20 74 68 65 20 | present| in the |
|00001280| 64 69 72 65 63 74 6f 72 | 79 2e 0d 5c 65 6e 64 7b |director|y..\end{|
|00001290| 66 75 6e 63 64 65 73 63 | 7d 0d 0d 5c 62 65 67 69 |funcdesc|}..\begi|
|000012a0| 6e 7b 66 75 6e 63 64 65 | 73 63 7d 7b 6c 73 65 65 |n{funcde|sc}{lsee|
|000012b0| 6b 7d 7b 66 64 5c 2c 20 | 70 6f 73 5c 2c 20 68 6f |k}{fd\, |pos\, ho|
|000012c0| 77 7d 0d 53 65 74 20 74 | 68 65 20 63 75 72 72 65 |w}.Set t|he curre|
|000012d0| 6e 74 20 70 6f 73 69 74 | 69 6f 6e 20 6f 66 20 66 |nt posit|ion of f|
|000012e0| 69 6c 65 20 64 65 73 63 | 72 69 70 74 6f 72 20 5c |ile desc|riptor \|
|000012f0| 76 61 72 7b 66 64 7d 20 | 74 6f 20 70 6f 73 69 74 |var{fd} |to posit|
|00001300| 69 6f 6e 0d 5c 76 61 72 | 7b 70 6f 73 7d 2c 20 6d |ion.\var|{pos}, m|
|00001310| 6f 64 69 66 69 65 64 20 | 62 79 20 5c 76 61 72 7b |odified |by \var{|
|00001320| 68 6f 77 7d 3a 20 30 20 | 74 6f 20 73 65 74 20 74 |how}: 0 |to set t|
|00001330| 68 65 20 70 6f 73 69 74 | 69 6f 6e 20 72 65 6c 61 |he posit|ion rela|
|00001340| 74 69 76 65 20 74 6f 0d | 74 68 65 20 62 65 67 69 |tive to.|the begi|
|00001350| 6e 6e 69 6e 67 20 6f 66 | 20 74 68 65 20 66 69 6c |nning of| the fil|
|00001360| 65 3b 20 31 20 74 6f 20 | 73 65 74 20 69 74 20 72 |e; 1 to |set it r|
|00001370| 65 6c 61 74 69 76 65 20 | 74 6f 20 74 68 65 20 63 |elative |to the c|
|00001380| 75 72 72 65 6e 74 0d 70 | 6f 73 69 74 69 6f 6e 3b |urrent.p|osition;|
|00001390| 20 32 20 74 6f 20 73 65 | 74 20 69 74 20 72 65 6c | 2 to se|t it rel|
|000013a0| 61 74 69 76 65 20 74 6f | 20 74 68 65 20 65 6e 64 |ative to| the end|
|000013b0| 20 6f 66 20 74 68 65 20 | 66 69 6c 65 2e 0d 5c 65 | of the |file..\e|
|000013c0| 6e 64 7b 66 75 6e 63 64 | 65 73 63 7d 0d 0d 5c 62 |nd{funcd|esc}..\b|
|000013d0| 65 67 69 6e 7b 66 75 6e | 63 64 65 73 63 7d 7b 6c |egin{fun|cdesc}{l|
|000013e0| 73 74 61 74 7d 7b 70 61 | 74 68 7d 0d 4c 69 6b 65 |stat}{pa|th}.Like|
|000013f0| 20 5c 63 6f 64 65 7b 73 | 74 61 74 28 29 7d 2c 20 | \code{s|tat()}, |
|00001400| 62 75 74 20 64 6f 20 6e | 6f 74 20 66 6f 6c 6c 6f |but do n|ot follo|
|00001410| 77 20 73 79 6d 62 6f 6c | 69 63 20 6c 69 6e 6b 73 |w symbol|ic links|
|00001420| 2e 20 20 28 4f 6e 20 73 | 79 73 74 65 6d 73 0d 77 |.  (On s|ystems.w|
|00001430| 69 74 68 6f 75 74 20 73 | 79 6d 62 6f 6c 69 63 20 |ithout s|ymbolic |
|00001440| 6c 69 6e 6b 73 2c 20 74 | 68 69 73 20 69 73 20 69 |links, t|his is i|
|00001450| 64 65 6e 74 69 63 61 6c | 20 74 6f 20 5c 63 6f 64 |dentical| to \cod|
|00001460| 65 7b 70 6f 73 69 78 2e | 73 74 61 74 7d 2e 29 0d |e{posix.|stat}.).|
|00001470| 5c 65 6e 64 7b 66 75 6e | 63 64 65 73 63 7d 0d 0d |\end{fun|cdesc}..|
|00001480| 5c 62 65 67 69 6e 7b 66 | 75 6e 63 64 65 73 63 7d |\begin{f|uncdesc}|
|00001490| 7b 6d 6b 64 69 72 7d 7b | 70 61 74 68 5c 2c 20 6d |{mkdir}{|path\, m|
|000014a0| 6f 64 65 7d 0d 43 72 65 | 61 74 65 20 61 20 64 69 |ode}.Cre|ate a di|
|000014b0| 72 65 63 74 6f 72 79 20 | 6e 61 6d 65 64 20 5c 76 |rectory |named \v|
|000014c0| 61 72 7b 70 61 74 68 7d | 20 77 69 74 68 20 6e 75 |ar{path}| with nu|
|000014d0| 6d 65 72 69 63 20 6d 6f | 64 65 20 5c 76 61 72 7b |meric mo|de \var{|
|000014e0| 6d 6f 64 65 7d 2e 0d 5c | 65 6e 64 7b 66 75 6e 63 |mode}..\|end{func|
|000014f0| 64 65 73 63 7d 0d 0d 5c | 62 65 67 69 6e 7b 66 75 |desc}..\|begin{fu|
|00001500| 6e 63 64 65 73 63 7d 7b | 6e 69 63 65 7d 7b 69 6e |ncdesc}{|nice}{in|
|00001510| 63 72 65 6d 65 6e 74 7d | 0d 41 64 64 20 5c 76 61 |crement}|.Add \va|
|00001520| 72 7b 69 6e 63 72 7d 20 | 74 6f 20 74 68 65 20 70 |r{incr} |to the p|
|00001530| 72 6f 63 65 73 73 27 20 | 60 60 6e 69 63 65 6e 65 |rocess' |``nicene|
|00001540| 73 73 27 27 2e 20 20 52 | 65 74 75 72 6e 20 74 68 |ss''.  R|eturn th|
|00001550| 65 20 6e 65 77 20 6e 69 | 63 65 6e 65 73 73 2e 0d |e new ni|ceness..|
|00001560| 28 4e 6f 74 20 6f 6e 20 | 4d 53 2d 44 4f 53 2e 29 |(Not on |MS-DOS.)|
|00001570| 0d 5c 65 6e 64 7b 66 75 | 6e 63 64 65 73 63 7d 0d |.\end{fu|ncdesc}.|
|00001580| 0d 5c 62 65 67 69 6e 7b | 66 75 6e 63 64 65 73 63 |.\begin{|funcdesc|
|00001590| 7d 7b 6f 70 65 6e 7d 7b | 66 69 6c 65 5c 2c 20 66 |}{open}{|file\, f|
|000015a0| 6c 61 67 73 5c 2c 20 6d | 6f 64 65 7d 0d 4f 70 65 |lags\, m|ode}.Ope|
|000015b0| 6e 20 74 68 65 20 66 69 | 6c 65 20 5c 76 61 72 7b |n the fi|le \var{|
|000015c0| 66 69 6c 65 7d 20 61 6e | 64 20 73 65 74 20 76 61 |file} an|d set va|
|000015d0| 72 69 6f 75 73 20 66 6c | 61 67 73 20 61 63 63 6f |rious fl|ags acco|
|000015e0| 72 64 69 6e 67 20 74 6f | 0d 5c 76 61 72 7b 66 6c |rding to|.\var{fl|
|000015f0| 61 67 73 7d 20 61 6e 64 | 20 70 6f 73 73 69 62 6c |ags} and| possibl|
|00001600| 79 20 69 74 73 20 6d 6f | 64 65 20 61 63 63 6f 72 |y its mo|de accor|
|00001610| 64 69 6e 67 20 74 6f 20 | 5c 76 61 72 7b 6d 6f 64 |ding to |\var{mod|
|00001620| 65 7d 2e 0d 52 65 74 75 | 72 6e 20 74 68 65 20 66 |e}..Retu|rn the f|
|00001630| 69 6c 65 20 64 65 73 63 | 72 69 70 74 6f 72 20 66 |ile desc|riptor f|
|00001640| 6f 72 20 74 68 65 20 6e | 65 77 6c 79 20 6f 70 65 |or the n|ewly ope|
|00001650| 6e 65 64 20 66 69 6c 65 | 2e 0d 5c 65 6e 64 7b 66 |ned file|..\end{f|
|00001660| 75 6e 63 64 65 73 63 7d | 0d 0d 5c 62 65 67 69 6e |uncdesc}|..\begin|
|00001670| 7b 66 75 6e 63 64 65 73 | 63 7d 7b 70 69 70 65 7d |{funcdes|c}{pipe}|
|00001680| 7b 7d 0d 43 72 65 61 74 | 65 20 61 20 70 69 70 65 |{}.Creat|e a pipe|
|00001690| 2e 20 20 52 65 74 75 72 | 6e 20 61 20 70 61 69 72 |.  Retur|n a pair|
|000016a0| 20 6f 66 20 66 69 6c 65 | 20 64 65 73 63 72 69 70 | of file| descrip|
|000016b0| 74 6f 72 73 20 5c 63 6f | 64 65 7b 28 72 2c 20 77 |tors \co|de{(r, w|
|000016c0| 29 7d 0d 75 73 61 62 6c | 65 20 66 6f 72 20 72 65 |)}.usabl|e for re|
|000016d0| 61 64 69 6e 67 20 61 6e | 64 20 77 72 69 74 69 6e |ading an|d writin|
|000016e0| 67 2c 20 72 65 73 70 65 | 63 74 69 76 65 6c 79 2e |g, respe|ctively.|
|000016f0| 0d 28 4e 6f 74 20 6f 6e | 20 4d 53 2d 44 4f 53 2e |.(Not on| MS-DOS.|
|00001700| 29 0d 5c 65 6e 64 7b 66 | 75 6e 63 64 65 73 63 7d |).\end{f|uncdesc}|
|00001710| 0d 0d 5c 62 65 67 69 6e | 7b 66 75 6e 63 64 65 73 |..\begin|{funcdes|
|00001720| 63 7d 7b 70 6f 70 65 6e | 7d 7b 63 6f 6d 6d 61 6e |c}{popen|}{comman|
|00001730| 64 5c 2c 20 6d 6f 64 65 | 7d 0d 4f 70 65 6e 20 61 |d\, mode|}.Open a|
|00001740| 20 70 69 70 65 20 74 6f | 20 6f 72 20 66 72 6f 6d | pipe to| or from|
|00001750| 20 5c 76 61 72 7b 63 6f | 6d 6d 61 6e 64 7d 2e 20 | \var{co|mmand}. |
|00001760| 20 54 68 65 20 72 65 74 | 75 72 6e 20 76 61 6c 75 | The ret|urn valu|
|00001770| 65 20 69 73 20 61 6e 20 | 6f 70 65 6e 0d 66 69 6c |e is an |open.fil|
|00001780| 65 20 6f 62 6a 65 63 74 | 20 63 6f 6e 6e 65 63 74 |e object| connect|
|00001790| 65 64 20 74 6f 20 74 68 | 65 20 70 69 70 65 2c 20 |ed to th|e pipe, |
|000017a0| 77 68 69 63 68 20 63 61 | 6e 20 62 65 20 72 65 61 |which ca|n be rea|
|000017b0| 64 20 6f 72 20 77 72 69 | 74 74 65 6e 0d 64 65 70 |d or wri|tten.dep|
|000017c0| 65 6e 64 69 6e 67 20 6f | 6e 20 77 68 65 74 68 65 |ending o|n whethe|
|000017d0| 72 20 5c 76 61 72 7b 6d | 6f 64 65 7d 20 69 73 20 |r \var{m|ode} is |
|000017e0| 5c 63 6f 64 65 7b 27 72 | 27 7d 20 6f 72 20 5c 63 |\code{'r|'} or \c|
|000017f0| 6f 64 65 7b 27 77 27 7d | 2e 0d 28 4e 6f 74 20 6f |ode{'w'}|..(Not o|
|00001800| 6e 20 4d 53 2d 44 4f 53 | 2e 29 0d 5c 65 6e 64 7b |n MS-DOS|.).\end{|
|00001810| 66 75 6e 63 64 65 73 63 | 7d 0d 0d 5c 62 65 67 69 |funcdesc|}..\begi|
|00001820| 6e 7b 66 75 6e 63 64 65 | 73 63 7d 7b 72 65 61 64 |n{funcde|sc}{read|
|00001830| 7d 7b 66 64 5c 2c 20 6e | 7d 0d 52 65 61 64 20 61 |}{fd\, n|}.Read a|
|00001840| 74 20 6d 6f 73 74 20 5c | 76 61 72 7b 6e 7d 20 62 |t most \|var{n} b|
|00001850| 79 74 65 73 20 66 72 6f | 6d 20 66 69 6c 65 20 64 |ytes fro|m file d|
|00001860| 65 73 63 72 69 70 74 6f | 72 20 5c 76 61 72 7b 66 |escripto|r \var{f|
|00001870| 64 7d 2e 0d 52 65 74 75 | 72 6e 20 61 20 73 74 72 |d}..Retu|rn a str|
|00001880| 69 6e 67 20 63 6f 6e 74 | 61 69 6e 69 6e 67 20 74 |ing cont|aining t|
|00001890| 68 65 20 62 79 74 65 73 | 20 72 65 61 64 2e 0d 5c |he bytes| read..\|
|000018a0| 65 6e 64 7b 66 75 6e 63 | 64 65 73 63 7d 0d 0d 5c |end{func|desc}..\|
|000018b0| 62 65 67 69 6e 7b 66 75 | 6e 63 64 65 73 63 7d 7b |begin{fu|ncdesc}{|
|000018c0| 72 65 61 64 6c 69 6e 6b | 7d 7b 70 61 74 68 7d 0d |readlink|}{path}.|
|000018d0| 52 65 74 75 72 6e 20 61 | 20 73 74 72 69 6e 67 20 |Return a| string |
|000018e0| 72 65 70 72 65 73 65 6e | 74 69 6e 67 20 74 68 65 |represen|ting the|
|000018f0| 20 70 61 74 68 20 74 6f | 20 77 68 69 63 68 20 74 | path to| which t|
|00001900| 68 65 20 73 79 6d 62 6f | 6c 69 63 20 6c 69 6e 6b |he symbo|lic link|
|00001910| 0d 70 6f 69 6e 74 73 2e | 20 20 28 4f 6e 20 73 79 |.points.|  (On sy|
|00001920| 73 74 65 6d 73 20 77 69 | 74 68 6f 75 74 20 73 79 |stems wi|thout sy|
|00001930| 6d 62 6f 6c 69 63 20 6c | 69 6e 6b 73 2c 20 74 68 |mbolic l|inks, th|
|00001940| 69 73 20 61 6c 77 61 79 | 73 20 72 61 69 73 65 73 |is alway|s raises|
|00001950| 0d 5c 63 6f 64 65 7b 70 | 6f 73 69 78 2e 65 72 72 |.\code{p|osix.err|
|00001960| 6f 72 7d 2e 29 0d 5c 65 | 6e 64 7b 66 75 6e 63 64 |or}.).\e|nd{funcd|
|00001970| 65 73 63 7d 0d 0d 5c 62 | 65 67 69 6e 7b 66 75 6e |esc}..\b|egin{fun|
|00001980| 63 64 65 73 63 7d 7b 72 | 65 6e 61 6d 65 7d 7b 73 |cdesc}{r|ename}{s|
|00001990| 72 63 5c 2c 20 64 73 74 | 7d 0d 52 65 6e 61 6d 65 |rc\, dst|}.Rename|
|000019a0| 20 74 68 65 20 66 69 6c | 65 20 6f 72 20 64 69 72 | the fil|e or dir|
|000019b0| 65 63 74 6f 72 79 20 5c | 76 61 72 7b 73 72 63 7d |ectory \|var{src}|
|000019c0| 20 74 6f 20 5c 76 61 72 | 7b 64 73 74 7d 2e 0d 5c | to \var|{dst}..\|
|000019d0| 65 6e 64 7b 66 75 6e 63 | 64 65 73 63 7d 0d 0d 5c |end{func|desc}..\|
|000019e0| 62 65 67 69 6e 7b 66 75 | 6e 63 64 65 73 63 7d 7b |begin{fu|ncdesc}{|
|000019f0| 72 6d 64 69 72 7d 7b 70 | 61 74 68 7d 0d 52 65 6d |rmdir}{p|ath}.Rem|
|00001a00| 6f 76 65 20 74 68 65 20 | 64 69 72 65 63 74 6f 72 |ove the |director|
|00001a10| 79 20 5c 76 61 72 7b 70 | 61 74 68 7d 2e 0d 5c 65 |y \var{p|ath}..\e|
|00001a20| 6e 64 7b 66 75 6e 63 64 | 65 73 63 7d 0d 0d 5c 62 |nd{funcd|esc}..\b|
|00001a30| 65 67 69 6e 7b 66 75 6e | 63 64 65 73 63 7d 7b 73 |egin{fun|cdesc}{s|
|00001a40| 65 74 67 69 64 7d 7b 67 | 69 64 7d 0d 53 65 74 20 |etgid}{g|id}.Set |
|00001a50| 74 68 65 20 63 75 72 72 | 65 6e 74 20 70 72 6f 63 |the curr|ent proc|
|00001a60| 65 73 73 27 73 20 67 72 | 6f 75 70 20 69 64 2e 0d |ess's gr|oup id..|
|00001a70| 28 4e 6f 74 20 6f 6e 20 | 4d 53 2d 44 4f 53 2e 29 |(Not on |MS-DOS.)|
|00001a80| 0d 5c 65 6e 64 7b 66 75 | 6e 63 64 65 73 63 7d 0d |.\end{fu|ncdesc}.|
|00001a90| 0d 5c 62 65 67 69 6e 7b | 66 75 6e 63 64 65 73 63 |.\begin{|funcdesc|
|00001aa0| 7d 7b 73 65 74 75 69 64 | 7d 7b 75 69 64 7d 0d 53 |}{setuid|}{uid}.S|
|00001ab0| 65 74 20 74 68 65 20 63 | 75 72 72 65 6e 74 20 70 |et the c|urrent p|
|00001ac0| 72 6f 63 65 73 73 27 73 | 20 75 73 65 72 20 69 64 |rocess's| user id|
|00001ad0| 2e 0d 28 4e 6f 74 20 6f | 6e 20 4d 53 2d 44 4f 53 |..(Not o|n MS-DOS|
|00001ae0| 2e 29 0d 5c 65 6e 64 7b | 66 75 6e 63 64 65 73 63 |.).\end{|funcdesc|
|00001af0| 7d 0d 0d 5c 62 65 67 69 | 6e 7b 66 75 6e 63 64 65 |}..\begi|n{funcde|
|00001b00| 73 63 7d 7b 73 74 61 74 | 7d 7b 70 61 74 68 7d 0d |sc}{stat|}{path}.|
|00001b10| 50 65 72 66 6f 72 6d 20 | 61 20 7b 5c 65 6d 20 73 |Perform |a {\em s|
|00001b20| 74 61 74 7d 20 73 79 73 | 74 65 6d 20 63 61 6c 6c |tat} sys|tem call|
|00001b30| 20 6f 6e 20 74 68 65 20 | 67 69 76 65 6e 20 70 61 | on the |given pa|
|00001b40| 74 68 2e 20 20 54 68 65 | 20 72 65 74 75 72 6e 20 |th.  The| return |
|00001b50| 76 61 6c 75 65 0d 69 73 | 20 61 20 74 75 70 6c 65 |value.is| a tuple|
|00001b60| 20 6f 66 20 61 74 20 6c | 65 61 73 74 20 31 30 20 | of at l|east 10 |
|00001b70| 69 6e 74 65 67 65 72 73 | 20 67 69 76 69 6e 67 20 |integers| giving |
|00001b80| 74 68 65 20 6d 6f 73 74 | 20 69 6d 70 6f 72 74 61 |the most| importa|
|00001b90| 6e 74 20 28 61 6e 64 0d | 70 6f 72 74 61 62 6c 65 |nt (and.|portable|
|00001ba0| 29 20 6d 65 6d 62 65 72 | 73 20 6f 66 20 74 68 65 |) member|s of the|
|00001bb0| 20 7b 5c 65 6d 20 73 74 | 61 74 7d 20 73 74 72 75 | {\em st|at} stru|
|00001bc0| 63 74 75 72 65 2c 20 69 | 6e 20 74 68 65 20 6f 72 |cture, i|n the or|
|00001bd0| 64 65 72 0d 5c 63 6f 64 | 65 7b 73 74 5f 6d 6f 64 |der.\cod|e{st_mod|
|00001be0| 65 7d 2c 0d 5c 63 6f 64 | 65 7b 73 74 5f 69 6e 6f |e},.\cod|e{st_ino|
|00001bf0| 7d 2c 0d 5c 63 6f 64 65 | 7b 73 74 5f 64 65 76 7d |},.\code|{st_dev}|
|00001c00| 2c 0d 5c 63 6f 64 65 7b | 73 74 5f 6e 6c 69 6e 6b |,.\code{|st_nlink|
|00001c10| 7d 2c 0d 5c 63 6f 64 65 | 7b 73 74 5f 75 69 64 7d |},.\code|{st_uid}|
|00001c20| 2c 0d 5c 63 6f 64 65 7b | 73 74 5f 67 69 64 7d 2c |,.\code{|st_gid},|
|00001c30| 0d 5c 63 6f 64 65 7b 73 | 74 5f 73 69 7a 65 7d 2c |.\code{s|t_size},|
|00001c40| 0d 5c 63 6f 64 65 7b 73 | 74 5f 61 74 69 6d 65 7d |.\code{s|t_atime}|
|00001c50| 2c 0d 5c 63 6f 64 65 7b | 73 74 5f 6d 74 69 6d 65 |,.\code{|st_mtime|
|00001c60| 7d 2c 0d 5c 63 6f 64 65 | 7b 73 74 5f 63 74 69 6d |},.\code|{st_ctim|
|00001c70| 65 7d 2e 0d 4d 6f 72 65 | 20 69 74 65 6d 73 20 6d |e}..More| items m|
|00001c80| 61 79 20 62 65 20 61 64 | 64 65 64 20 61 74 20 74 |ay be ad|ded at t|
|00001c90| 68 65 20 65 6e 64 20 62 | 79 20 73 6f 6d 65 20 69 |he end b|y some i|
|00001ca0| 6d 70 6c 65 6d 65 6e 74 | 61 74 69 6f 6e 73 2e 0d |mplement|ations..|
|00001cb0| 28 4f 6e 20 4d 53 2d 44 | 4f 53 2c 20 73 6f 6d 65 |(On MS-D|OS, some|
|00001cc0| 20 69 74 65 6d 73 20 61 | 72 65 20 66 69 6c 6c 65 | items a|re fille|
|00001cd0| 64 20 77 69 74 68 20 64 | 75 6d 6d 79 20 76 61 6c |d with d|ummy val|
|00001ce0| 75 65 73 2e 29 0d 0d 4e | 6f 74 65 3a 20 54 68 65 |ues.)..N|ote: The|
|00001cf0| 20 73 74 61 6e 64 61 72 | 64 20 6d 6f 64 75 6c 65 | standar|d module|
|00001d00| 20 5c 63 6f 64 65 7b 73 | 74 61 74 7d 20 64 65 66 | \code{s|tat} def|
|00001d10| 69 6e 65 73 20 66 75 6e | 63 74 69 6f 6e 73 20 61 |ines fun|ctions a|
|00001d20| 6e 64 20 63 6f 6e 73 74 | 61 6e 74 73 0d 74 68 61 |nd const|ants.tha|
|00001d30| 74 20 61 72 65 20 75 73 | 65 66 75 6c 20 66 6f 72 |t are us|eful for|
|00001d40| 20 65 78 74 72 61 63 74 | 69 6e 67 20 69 6e 66 6f | extract|ing info|
|00001d50| 72 6d 61 74 69 6f 6e 20 | 66 72 6f 6d 20 61 20 73 |rmation |from a s|
|00001d60| 74 61 74 20 73 74 72 75 | 63 74 75 72 65 2e 0d 5c |tat stru|cture..\|
|00001d70| 65 6e 64 7b 66 75 6e 63 | 64 65 73 63 7d 0d 0d 5c |end{func|desc}..\|
|00001d80| 62 65 67 69 6e 7b 66 75 | 6e 63 64 65 73 63 7d 7b |begin{fu|ncdesc}{|
|00001d90| 73 79 6d 6c 69 6e 6b 7d | 7b 73 72 63 5c 2c 20 64 |symlink}|{src\, d|
|00001da0| 73 74 7d 0d 43 72 65 61 | 74 65 20 61 20 73 79 6d |st}.Crea|te a sym|
|00001db0| 62 6f 6c 69 63 20 6c 69 | 6e 6b 20 70 6f 69 6e 74 |bolic li|nk point|
|00001dc0| 69 6e 67 20 74 6f 20 5c | 76 61 72 7b 73 72 63 7d |ing to \|var{src}|
|00001dd0| 20 6e 61 6d 65 64 20 5c | 76 61 72 7b 64 73 74 7d | named \|var{dst}|
|00001de0| 2e 20 20 28 4f 6e 0d 73 | 79 73 74 65 6d 73 20 77 |.  (On.s|ystems w|
|00001df0| 69 74 68 6f 75 74 20 73 | 79 6d 62 6f 6c 69 63 20 |ithout s|ymbolic |
|00001e00| 6c 69 6e 6b 73 2c 20 74 | 68 69 73 20 61 6c 77 61 |links, t|his alwa|
|00001e10| 79 73 20 72 61 69 73 65 | 73 0d 5c 63 6f 64 65 7b |ys raise|s.\code{|
|00001e20| 70 6f 73 69 78 2e 65 72 | 72 6f 72 7d 2e 29 0d 5c |posix.er|ror}.).\|
|00001e30| 65 6e 64 7b 66 75 6e 63 | 64 65 73 63 7d 0d 0d 5c |end{func|desc}..\|
|00001e40| 62 65 67 69 6e 7b 66 75 | 6e 63 64 65 73 63 7d 7b |begin{fu|ncdesc}{|
|00001e50| 73 79 73 74 65 6d 7d 7b | 63 6f 6d 6d 61 6e 64 7d |system}{|command}|
|00001e60| 0d 45 78 65 63 75 74 65 | 20 74 68 65 20 63 6f 6d |.Execute| the com|
|00001e70| 6d 61 6e 64 20 28 61 20 | 73 74 72 69 6e 67 29 20 |mand (a |string) |
|00001e80| 69 6e 20 61 20 73 75 62 | 73 68 65 6c 6c 2e 20 20 |in a sub|shell.  |
|00001e90| 54 68 69 73 20 69 73 20 | 69 6d 70 6c 65 6d 65 6e |This is |implemen|
|00001ea0| 74 65 64 20 62 79 0d 63 | 61 6c 6c 69 6e 67 20 74 |ted by.c|alling t|
|00001eb0| 68 65 20 53 74 61 6e 64 | 61 72 64 20 43 20 66 75 |he Stand|ard C fu|
|00001ec0| 6e 63 74 69 6f 6e 20 5c | 63 6f 64 65 7b 73 79 73 |nction \|code{sys|
|00001ed0| 74 65 6d 28 29 7d 2c 20 | 61 6e 64 20 68 61 73 20 |tem()}, |and has |
|00001ee0| 74 68 65 20 73 61 6d 65 | 0d 6c 69 6d 69 74 61 74 |the same|.limitat|
|00001ef0| 69 6f 6e 73 2e 20 20 43 | 68 61 6e 67 65 73 20 74 |ions.  C|hanges t|
|00001f00| 6f 20 5c 63 6f 64 65 7b | 70 6f 73 69 78 2e 65 6e |o \code{|posix.en|
|00001f10| 76 69 72 6f 6e 7d 2c 20 | 5c 63 6f 64 65 7b 73 79 |viron}, |\code{sy|
|00001f20| 73 2e 73 74 64 69 6e 7d | 20 65 74 63 2e 20 61 72 |s.stdin}| etc. ar|
|00001f30| 65 0d 6e 6f 74 20 72 65 | 66 6c 65 63 74 65 64 20 |e.not re|flected |
|00001f40| 69 6e 20 74 68 65 20 65 | 6e 76 69 72 6f 6e 6d 65 |in the e|nvironme|
|00001f50| 6e 74 20 6f 66 20 74 68 | 65 20 65 78 65 63 75 74 |nt of th|e execut|
|00001f60| 65 64 20 63 6f 6d 6d 61 | 6e 64 2e 20 20 54 68 65 |ed comma|nd.  The|
|00001f70| 20 72 65 74 75 72 6e 0d | 76 61 6c 75 65 20 69 73 | return.|value is|
|00001f80| 20 74 68 65 20 65 78 69 | 74 20 73 74 61 74 75 73 | the exi|t status|
|00001f90| 20 6f 66 20 74 68 65 20 | 70 72 6f 63 65 73 73 20 | of the |process |
|00001fa0| 61 73 20 72 65 74 75 72 | 6e 65 64 20 62 79 20 53 |as retur|ned by S|
|00001fb0| 74 61 6e 64 61 72 64 20 | 43 0d 5c 63 6f 64 65 7b |tandard |C.\code{|
|00001fc0| 73 79 73 74 65 6d 28 29 | 7d 2e 0d 5c 65 6e 64 7b |system()|}..\end{|
|00001fd0| 66 75 6e 63 64 65 73 63 | 7d 0d 0d 5c 62 65 67 69 |funcdesc|}..\begi|
|00001fe0| 6e 7b 66 75 6e 63 64 65 | 73 63 7d 7b 74 69 6d 65 |n{funcde|sc}{time|
|00001ff0| 73 7d 7b 7d 0d 52 65 74 | 75 72 6e 20 61 20 34 2d |s}{}.Ret|urn a 4-|
|00002000| 74 75 70 6c 65 20 6f 66 | 20 66 6c 6f 61 74 69 6e |tuple of| floatin|
|00002010| 67 20 70 6f 69 6e 74 20 | 6e 75 6d 62 65 72 73 20 |g point |numbers |
|00002020| 69 6e 64 69 63 61 74 69 | 6e 67 20 61 63 63 75 6d |indicati|ng accum|
|00002030| 75 6c 61 74 65 64 20 43 | 50 55 0d 74 69 6d 65 73 |ulated C|PU.times|
|00002040| 2c 20 69 6e 20 73 65 63 | 6f 6e 64 73 2e 20 20 54 |, in sec|onds.  T|
|00002050| 68 65 20 69 74 65 6d 73 | 20 61 72 65 3a 20 75 73 |he items| are: us|
|00002060| 65 72 20 74 69 6d 65 2c | 20 73 79 73 74 65 6d 20 |er time,| system |
|00002070| 74 69 6d 65 2c 20 63 68 | 69 6c 64 72 65 6e 27 73 |time, ch|ildren's|
|00002080| 0d 75 73 65 72 20 74 69 | 6d 65 2c 20 61 6e 64 20 |.user ti|me, and |
|00002090| 63 68 69 6c 64 72 65 6e | 27 73 20 73 79 73 74 65 |children|'s syste|
|000020a0| 6d 20 74 69 6d 65 2c 20 | 69 6e 20 74 68 61 74 20 |m time, |in that |
|000020b0| 6f 72 64 65 72 2e 20 20 | 53 65 65 20 74 68 65 20 |order.  |See the |
|000020c0| 5c 55 4e 49 58 7b 7d 0d | 6d 61 6e 75 61 6c 20 70 |\UNIX{}.|manual p|
|000020d0| 61 67 65 20 7b 5c 69 74 | 20 74 69 6d 65 73 7d 28 |age {\it| times}(|
|000020e0| 32 29 2e 20 20 28 4e 6f | 74 20 6f 6e 20 4d 53 2d |2).  (No|t on MS-|
|000020f0| 44 4f 53 2e 29 0d 5c 65 | 6e 64 7b 66 75 6e 63 64 |DOS.).\e|nd{funcd|
|00002100| 65 73 63 7d 0d 0d 5c 62 | 65 67 69 6e 7b 66 75 6e |esc}..\b|egin{fun|
|00002110| 63 64 65 73 63 7d 7b 75 | 6d 61 73 6b 7d 7b 6d 61 |cdesc}{u|mask}{ma|
|00002120| 73 6b 7d 0d 53 65 74 20 | 74 68 65 20 63 75 72 72 |sk}.Set |the curr|
|00002130| 65 6e 74 20 6e 75 6d 65 | 72 69 63 20 75 6d 61 73 |ent nume|ric umas|
|00002140| 6b 20 61 6e 64 20 72 65 | 74 75 72 6e 73 20 74 68 |k and re|turns th|
|00002150| 65 20 70 72 65 76 69 6f | 75 73 20 75 6d 61 73 6b |e previo|us umask|
|00002160| 2e 0d 28 4e 6f 74 20 6f | 6e 20 4d 53 2d 44 4f 53 |..(Not o|n MS-DOS|
|00002170| 2e 29 0d 5c 65 6e 64 7b | 66 75 6e 63 64 65 73 63 |.).\end{|funcdesc|
|00002180| 7d 0d 0d 5c 62 65 67 69 | 6e 7b 66 75 6e 63 64 65 |}..\begi|n{funcde|
|00002190| 73 63 7d 7b 75 6e 61 6d | 65 7d 7b 7d 0d 52 65 74 |sc}{unam|e}{}.Ret|
|000021a0| 75 72 6e 20 61 20 35 2d | 74 75 70 6c 65 20 63 6f |urn a 5-|tuple co|
|000021b0| 6e 74 61 69 6e 69 6e 67 | 20 69 6e 66 6f 72 6d 61 |ntaining| informa|
|000021c0| 74 69 6f 6e 20 69 64 65 | 6e 74 69 66 79 69 6e 67 |tion ide|ntifying|
|000021d0| 20 74 68 65 20 63 75 72 | 72 65 6e 74 0d 6f 70 65 | the cur|rent.ope|
|000021e0| 72 61 74 69 6e 67 20 73 | 79 73 74 65 6d 2e 20 20 |rating s|ystem.  |
|000021f0| 54 68 65 20 74 75 70 6c | 65 20 63 6f 6e 74 61 69 |The tupl|e contai|
|00002200| 6e 73 20 35 20 73 74 72 | 69 6e 67 73 3a 0d 5c 63 |ns 5 str|ings:.\c|
|00002210| 6f 64 65 7b 28 5c 76 61 | 72 7b 73 79 73 6e 61 6d |ode{(\va|r{sysnam|
|00002220| 65 7d 2c 20 5c 76 61 72 | 7b 6e 6f 64 65 6e 61 6d |e}, \var|{nodenam|
|00002230| 65 7d 2c 20 5c 76 61 72 | 7b 72 65 6c 65 61 73 65 |e}, \var|{release|
|00002240| 7d 2c 20 5c 76 61 72 7b | 76 65 72 73 69 6f 6e 7d |}, \var{|version}|
|00002250| 2c 20 5c 76 61 72 7b 6d | 61 63 68 69 6e 65 7d 29 |, \var{m|achine})|
|00002260| 7d 2e 0d 53 6f 6d 65 20 | 73 79 73 74 65 6d 73 20 |}..Some |systems |
|00002270| 74 72 75 6e 63 61 74 65 | 20 74 68 65 20 6e 6f 64 |truncate| the nod|
|00002280| 65 6e 61 6d 65 20 74 6f | 20 38 0d 63 68 61 72 61 |ename to| 8.chara|
|00002290| 63 74 65 72 73 20 6f 72 | 20 74 6f 20 74 68 65 20 |cters or| to the |
|000022a0| 6c 65 61 64 69 6e 67 20 | 63 6f 6d 70 6f 6e 65 6e |leading |componen|
|000022b0| 74 3b 20 61 6e 20 62 65 | 74 74 65 72 20 77 61 79 |t; an be|tter way|
|000022c0| 20 74 6f 20 67 65 74 20 | 74 68 65 0d 68 6f 73 74 | to get |the.host|
|000022d0| 6e 61 6d 65 20 69 73 20 | 5c 63 6f 64 65 7b 73 6f |name is |\code{so|
|000022e0| 63 6b 65 74 2e 67 65 74 | 68 6f 73 74 6e 61 6d 65 |cket.get|hostname|
|000022f0| 28 29 7d 2e 20 20 28 4e | 6f 74 20 6f 6e 20 4d 53 |()}.  (N|ot on MS|
|00002300| 2d 44 4f 53 2c 20 6e 6f | 72 20 6f 6e 20 6f 6c 64 |-DOS, no|r on old|
|00002310| 65 72 0d 5c 55 4e 49 58 | 7b 7d 20 73 79 73 74 65 |er.\UNIX|{} syste|
|00002320| 6d 73 2e 29 0d 5c 65 6e | 64 7b 66 75 6e 63 64 65 |ms.).\en|d{funcde|
|00002330| 73 63 7d 0d 0d 5c 62 65 | 67 69 6e 7b 66 75 6e 63 |sc}..\be|gin{func|
|00002340| 64 65 73 63 7d 7b 75 6e | 6c 69 6e 6b 7d 7b 70 61 |desc}{un|link}{pa|
|00002350| 74 68 7d 0d 55 6e 6c 69 | 6e 6b 20 5c 76 61 72 7b |th}.Unli|nk \var{|
|00002360| 70 61 74 68 7d 2e 0d 5c | 65 6e 64 7b 66 75 6e 63 |path}..\|end{func|
|00002370| 64 65 73 63 7d 0d 0d 5c | 62 65 67 69 6e 7b 66 75 |desc}..\|begin{fu|
|00002380| 6e 63 64 65 73 63 7d 7b | 75 74 69 6d 65 7d 7b 70 |ncdesc}{|utime}{p|
|00002390| 61 74 68 5c 2c 20 5c 28 | 61 74 69 6d 65 5c 2c 20 |ath\, \(|atime\, |
|000023a0| 6d 74 69 6d 65 5c 29 7d | 0d 53 65 74 20 74 68 65 |mtime\)}|.Set the|
|000023b0| 20 61 63 63 65 73 73 20 | 61 6e 64 20 6d 6f 64 69 | access |and modi|
|000023c0| 66 69 65 64 20 74 69 6d | 65 20 6f 66 20 74 68 65 |fied tim|e of the|
|000023d0| 20 66 69 6c 65 20 74 6f | 20 74 68 65 20 67 69 76 | file to| the giv|
|000023e0| 65 6e 20 76 61 6c 75 65 | 73 2e 0d 28 54 68 65 20 |en value|s..(The |
|000023f0| 73 65 63 6f 6e 64 20 61 | 72 67 75 6d 65 6e 74 20 |second a|rgument |
|00002400| 69 73 20 61 20 74 75 70 | 6c 65 20 6f 66 20 74 77 |is a tup|le of tw|
|00002410| 6f 20 69 74 65 6d 73 2e | 29 0d 5c 65 6e 64 7b 66 |o items.|).\end{f|
|00002420| 75 6e 63 64 65 73 63 7d | 0d 0d 5c 62 65 67 69 6e |uncdesc}|..\begin|
|00002430| 7b 66 75 6e 63 64 65 73 | 63 7d 7b 77 61 69 74 7d |{funcdes|c}{wait}|
|00002440| 7b 7d 0d 57 61 69 74 20 | 66 6f 72 20 63 6f 6d 70 |{}.Wait |for comp|
|00002450| 6c 65 74 69 6f 6e 20 6f | 66 20 61 20 63 68 69 6c |letion o|f a chil|
|00002460| 64 20 70 72 6f 63 65 73 | 73 2c 20 61 6e 64 20 72 |d proces|s, and r|
|00002470| 65 74 75 72 6e 20 61 20 | 74 75 70 6c 65 20 63 6f |eturn a |tuple co|
|00002480| 6e 74 61 69 6e 69 6e 67 | 0d 69 74 73 20 70 69 64 |ntaining|.its pid|
|00002490| 20 61 6e 64 20 65 78 69 | 74 20 73 74 61 74 75 73 | and exi|t status|
|000024a0| 20 69 6e 64 69 63 61 74 | 69 6f 6e 20 28 65 6e 63 | indicat|ion (enc|
|000024b0| 6f 64 65 64 20 61 73 20 | 62 79 20 5c 55 4e 49 58 |oded as |by \UNIX|
|000024c0| 7b 7d 29 2e 0d 28 4e 6f | 74 20 6f 6e 20 4d 53 2d |{})..(No|t on MS-|
|000024d0| 44 4f 53 2e 29 0d 5c 65 | 6e 64 7b 66 75 6e 63 64 |DOS.).\e|nd{funcd|
|000024e0| 65 73 63 7d 0d 0d 5c 62 | 65 67 69 6e 7b 66 75 6e |esc}..\b|egin{fun|
|000024f0| 63 64 65 73 63 7d 7b 77 | 61 69 74 70 69 64 7d 7b |cdesc}{w|aitpid}{|
|00002500| 70 69 64 5c 2c 20 6f 70 | 74 69 6f 6e 73 7d 0d 57 |pid\, op|tions}.W|
|00002510| 61 69 74 20 66 6f 72 20 | 63 6f 6d 70 6c 65 74 69 |ait for |completi|
|00002520| 6f 6e 20 6f 66 20 61 20 | 63 68 69 6c 64 20 70 72 |on of a |child pr|
|00002530| 6f 63 65 73 73 20 67 69 | 76 65 6e 20 62 79 20 70 |ocess gi|ven by p|
|00002540| 72 6f 63 65 73 20 69 64 | 2c 20 61 6e 64 20 72 65 |roces id|, and re|
|00002550| 74 75 72 6e 0d 61 20 74 | 75 70 6c 65 20 63 6f 6e |turn.a t|uple con|
|00002560| 74 61 69 6e 69 6e 67 20 | 69 74 73 20 70 69 64 20 |taining |its pid |
|00002570| 61 6e 64 20 65 78 69 74 | 20 73 74 61 74 75 73 20 |and exit| status |
|00002580| 69 6e 64 69 63 61 74 69 | 6f 6e 20 28 65 6e 63 6f |indicati|on (enco|
|00002590| 64 65 64 20 61 73 20 62 | 79 0d 5c 55 4e 49 58 7b |ded as b|y.\UNIX{|
|000025a0| 7d 29 2e 20 20 54 68 65 | 20 73 65 6d 61 6e 74 69 |}).  The| semanti|
|000025b0| 63 73 20 6f 66 20 74 68 | 65 20 63 61 6c 6c 20 61 |cs of th|e call a|
|000025c0| 72 65 20 61 66 66 65 63 | 74 65 64 20 62 79 20 74 |re affec|ted by t|
|000025d0| 68 65 20 76 61 6c 75 65 | 20 6f 66 0d 74 68 65 20 |he value| of.the |
|000025e0| 69 6e 74 65 67 65 72 20 | 6f 70 74 69 6f 6e 73 2c |integer |options,|
|000025f0| 20 77 68 69 63 68 20 73 | 68 6f 75 6c 64 20 62 65 | which s|hould be|
|00002600| 20 30 20 66 6f 72 20 6e | 6f 72 6d 61 6c 20 6f 70 | 0 for n|ormal op|
|00002610| 65 72 61 74 69 6f 6e 2e | 20 20 28 49 66 20 74 68 |eration.|  (If th|
|00002620| 65 0d 73 79 73 74 65 6d | 20 64 6f 65 73 20 6e 6f |e.system| does no|
|00002630| 74 20 73 75 70 70 6f 72 | 74 20 77 61 69 74 70 69 |t suppor|t waitpi|
|00002640| 64 28 29 2c 20 74 68 69 | 73 20 61 6c 77 61 79 73 |d(), thi|s always|
|00002650| 20 72 61 69 73 65 73 0d | 5c 63 6f 64 65 7b 70 6f | raises.|\code{po|
|00002660| 73 69 78 2e 65 72 72 6f | 72 7d 2e 20 20 4e 6f 74 |six.erro|r}.  Not|
|00002670| 20 6f 6e 20 4d 53 2d 44 | 4f 53 2e 29 0d 5c 65 6e | on MS-D|OS.).\en|
|00002680| 64 7b 66 75 6e 63 64 65 | 73 63 7d 0d 0d 5c 62 65 |d{funcde|sc}..\be|
|00002690| 67 69 6e 7b 66 75 6e 63 | 64 65 73 63 7d 7b 77 72 |gin{func|desc}{wr|
|000026a0| 69 74 65 7d 7b 66 64 5c | 2c 20 73 74 72 7d 0d 57 |ite}{fd\|, str}.W|
|000026b0| 72 69 74 65 20 74 68 65 | 20 73 74 72 69 6e 67 20 |rite the| string |
|000026c0| 5c 76 61 72 7b 73 74 72 | 7d 20 74 6f 20 66 69 6c |\var{str|} to fil|
|000026d0| 65 20 64 65 73 63 72 69 | 70 74 6f 72 20 5c 76 61 |e descri|ptor \va|
|000026e0| 72 7b 66 64 7d 2e 0d 52 | 65 74 75 72 6e 20 74 68 |r{fd}..R|eturn th|
|000026f0| 65 20 6e 75 6d 62 65 72 | 20 6f 66 20 62 79 74 65 |e number| of byte|
|00002700| 73 20 61 63 74 75 61 6c | 6c 79 20 77 72 69 74 74 |s actual|ly writt|
|00002710| 65 6e 2e 0d 5c 65 6e 64 | 7b 66 75 6e 63 64 65 73 |en..\end|{funcdes|
|00002720| 63 7d 0d                |                         |c}.     |        |
+--------+-------------------------+-------------------------+--------+--------+